Skip to content

K8SPMDB-1634 improve open shift docs#368

Open
nastena1606 wants to merge 1 commit into
1.23.0from
K8SPSMDB-1634-Improve-OpenShift-docs
Open

K8SPMDB-1634 improve open shift docs#368
nastena1606 wants to merge 1 commit into
1.23.0from
K8SPSMDB-1634-Improve-OpenShift-docs

Conversation

@nastena1606

Copy link
Copy Markdown
Collaborator

No description provided.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot couldn't run its full agentic review because it didn't start before the timeout. Make sure your repository has a runner available, or add a copilot-code-review.yml file specifying one with the runs-on attribute. See the docs for more details.

Updates OpenShift upgrade documentation by separating OLM Operator/CRD upgrade instructions from database upgrade steps and adding more guidance around OLM behavior and customization.

Changes:

  • Refactored update_openshift.md to focus on Percona Server for MongoDB upgrade steps and link to the OLM Operator upgrade guide.
  • Expanded update-crd-olm.md with detailed explanation of how OLM upgrades work, how to persist Operator customizations, and the pre-upgrade initImage patch workflow.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.

File Description
docs/update_openshift.md Simplifies OpenShift DB upgrade flow, adds assumptions include, links out to OLM Operator upgrade doc, and clarifies PMM ordering.
docs/update-crd-olm.md Adds comprehensive OpenShift/OLM Operator+CRD upgrade guidance including CSV/subscription behavior and required pre-upgrade patching.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/update-crd-olm.md
If you have [installed the Operator on the OpenShift platform using OLM](openshift.md#install-the-operator-via-the-operator-lifecycle-manager-olm), you can upgrade the Operator within it.

1. List installed Operators for your Namespace to see if there are upgradable items.
If you know the OLM upgrade workflow, jump to the [update Deployment steps](#upgrade-the-operator).
Comment thread docs/update_openshift.md
# Upgrade Database and Operator on OpenShift
# Upgrade Percona Server for MongoDB on OpenShift

{%set commandName = 'oc' %}
Comment thread docs/update_openshift.md
"backup": {"image": "registry.connect.redhat.com/percona/percona-server-mongodb-operator-containers@sha256:a73889d61e996bc4fbc6b256a1284b60232565e128a64e4f94b2c424966772eb"}
}}'
```
4. We recommend to [update the PMM Server :octicons-link-external-16:](https://docs.percona.com/percona-monitoring-and-management/3/pmm-upgrade/index.html) **before** the upgrade of PMM Client. If you haven’t done it yet, exclude PMM Client from the list of images to update.
Comment thread docs/update-crd-olm.md
If you previously customized the Operator Deployment manually, these changes are overwritten during the upgrade.

The CRD may be updated too, if the new Operator version introduces schema changes.
However, OLM doesn't modify the `PerconaServerMongoDB` Custom Resource. It remains unchanged and continues running with its current configuration. For how to update it, refer to [Update Percona Server for MongoDB](update_openshift.md).
Comment thread docs/update_openshift.md
![image](assets/images/olm4.svg)

Click the "Upgrade available" link to see upgrade details, then click "Preview InstallPlan" button, and finally "Approve" to upgrade the Operator.
--8<-- "update-assumptions.md"
@nastena1606
nastena1606 marked this pull request as ready for review July 21, 2026 08:26
@nastena1606 nastena1606 changed the title K8 spsmdb 1634 improve open shift docs K8SPMDB-1634 improve open shift docs Jul 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants